home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 April: Mac OS SDK / Dev.CD Apr 99 SDK1.toast / Development Kits / Interfaces&Libraries / Universal / Interfaces / AIncludes / Start.a < prev    next >
Encoding:
Text File  |  1998-08-17  |  11.5 KB  |  351 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        Start.a
  3. ;
  4. ;    Contains:    Start Manager Interfaces.
  5. ;
  6. ;    Version:    Technology:    System 7.5
  7. ;                Release:    Universal Interfaces 3.2
  8. ;
  9. ;    Copyright:    © 1987-1993, 1996-1998 by Apple Computer, Inc., all rights reserved
  10. ;
  11. ;    Bugs?:        For bug reports, consult the following page on
  12. ;                the World Wide Web:
  13. ;
  14. ;                    http://developer.apple.com/bugreporter/
  15. ;
  16. ;
  17.     IF &TYPE('__START__') = 'UNDEFINED' THEN
  18. __START__ SET 1
  19.  
  20.     IF &TYPE('__MACTYPES__') = 'UNDEFINED' THEN
  21.     include 'MacTypes.a'
  22.     ENDIF
  23.     IF &TYPE('__FILES__') = 'UNDEFINED' THEN
  24.     include 'Files.a'
  25.     ENDIF
  26.  
  27. ; 
  28. ;    Important: When the major version number of kExtensionTableVersion and the value
  29. ;    returned by gestaltExtensionTableVersion change, it indicates that the Extension
  30. ;    Table startup mechanism has radically changed and code that doesn't know about
  31. ;    the new major version must not attempt to use the Extension Table startup
  32. ;    mechanism.
  33. ;    
  34. ;    Changes to the minor version number of kExtensionTableVersion indicate that the
  35. ;    definition of the ExtensionElement structure has been extended, but the fields
  36. ;    defined for previous minor versions of kExtensionTableVersion have not changed.
  37. ;
  38.  
  39.  
  40. kExtensionTableVersion            EQU        $00000100            ; current ExtensionTable version (1.0.0) 
  41. ;  ExtensionNotification message codes 
  42.  
  43. extNotificationBeforeFirst        EQU        0                    ; Before any extensions have loaded 
  44. extNotificationAfterLast        EQU        1                    ; After all extensions have loaded 
  45. extNotificationBeforeCurrent    EQU        2                    ; Before extension at extElementIndex is loaded 
  46. extNotificationAfterCurrent        EQU        3                    ; After extension at extElementIndex is loaded 
  47. ExtensionElement        RECORD 0
  48. fileName                 ds        Str31            ; offset: $0 (0)        ;  The file name 
  49. parentDirID                 ds.l    1                ; offset: $20 (32)        ;  the file's parent directory ID 
  50. ;  and everything after ioNamePtr in the HParamBlockRec.fileParam variant 
  51. ioVRefNum                 ds.w    1                ; offset: $24 (36)        ;  always the real volume reference number (not a drive, default, or working dirID) 
  52. ioFRefNum                 ds.w    1                ; offset: $26 (38)
  53. ioFVersNum                 ds.b    1                ; offset: $28 (40)
  54. filler1                     ds.b    1                ; offset: $29 (41)
  55. ioFDirIndex                 ds.w    1                ; offset: $2A (42)        ;  always 0 in table 
  56. ioFlAttrib                 ds.b    1                ; offset: $2C (44)
  57. ioFlVersNum                 ds.b    1                ; offset: $2D (45)
  58. ioFlFndrInfo             ds        FInfo            ; offset: $2E (46)
  59. ioDirID                     ds.l    1                ; offset: $3E (62)
  60. ioFlStBlk                 ds.w    1                ; offset: $42 (66)
  61. ioFlLgLen                 ds.l    1                ; offset: $44 (68)
  62. ioFlPyLen                 ds.l    1                ; offset: $48 (72)
  63. ioFlRStBlk                 ds.w    1                ; offset: $4C (76)
  64. ioFlRLgLen                 ds.l    1                ; offset: $4E (78)
  65. ioFlRPyLen                 ds.l    1                ; offset: $52 (82)
  66. ioFlCrDat                 ds.l    1                ; offset: $56 (86)
  67. ioFlMdDat                 ds.l    1                ; offset: $5A (90)
  68. sizeof                     EQU *                    ; size:   $5E (94)
  69.                         ENDR
  70. ; typedef struct ExtensionElement *        ExtensionElementPtr
  71.  
  72. ExtensionTableHeader    RECORD 0
  73. extTableHeaderSize         ds.l    1                ; offset: $0 (0)        ;  size of ExtensionTable header ( equal to offsetof(ExtensionTable, extElements[0]) ) 
  74. extTableVersion             ds.l    1                ; offset: $4 (4)        ;  current ExtensionTable version (same as returned by gestaltExtTableVersion Gestalt selector) 
  75. extElementIndex             ds.l    1                ; offset: $8 (8)        ;  current index into ExtensionElement records (zero-based) 
  76. extElementSize             ds.l    1                ; offset: $C (12)        ;  size of ExtensionElement 
  77. extElementCount             ds.l    1                ; offset: $10 (16)        ;  number of ExtensionElement records in table (1-based) 
  78. sizeof                     EQU *                    ; size:   $14 (20)
  79.                         ENDR
  80. ExtensionTable            RECORD 0
  81. extTableHeader             ds        ExtensionTableHeader ; offset: $0 (0)    ;  the ExtensionTableHeader 
  82. extElements                 ds        ExtensionElement ; offset: $14 (20) <-- really an array of length one ;  one element for each extension to load 
  83. sizeof                     EQU *                    ; size:   $72 (114)
  84.                         ENDR
  85. ; typedef struct ExtensionTable *        ExtensionTablePtr
  86.  
  87. ; typedef ExtensionTablePtr *            ExtensionTableHandle
  88.  
  89. DefStartRec                RECORD 0
  90. sdExtDevID                 ds.b    1                ; offset: $0 (0)
  91. sdPartition                 ds.b    1                ; offset: $1 (1)
  92. sdSlotNum                 ds.b    1                ; offset: $2 (2)
  93. sdSRsrcID                 ds.b    1                ; offset: $3 (3)
  94.                          ORG 0
  95. sdReserved1                 ds.b    1                ; offset: $0 (0)
  96. sdReserved2                 ds.b    1                ; offset: $1 (1)
  97. sdRefNum                 ds.w    1                ; offset: $2 (2)
  98. sizeof                     EQU *                    ; size:   $4 (4)
  99.                         ENDR
  100. ; typedef union DefStartRec *            DefStartPtr
  101.  
  102. DefVideoRec                RECORD 0
  103. sdSlot                     ds.b    1                ; offset: $0 (0)
  104. sdsResource                 ds.b    1                ; offset: $1 (1)
  105. sizeof                     EQU *                    ; size:   $2 (2)
  106.                         ENDR
  107. ; typedef struct DefVideoRec *            DefVideoPtr
  108.  
  109. DefOSRec                RECORD 0
  110. sdReserved                 ds.b    1                ; offset: $0 (0)
  111. sdOSType                 ds.b    1                ; offset: $1 (1)
  112. sizeof                     EQU *                    ; size:   $2 (2)
  113.                         ENDR
  114. ; typedef struct DefOSRec *                DefOSPtr
  115.  
  116. ;
  117. ; pascal void GetDefaultStartup(DefStartPtr paramBlock)
  118. ;
  119.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  120.         ; parameters:
  121.         ;    paramBlock      => A0
  122.         _GetDefaultStartup:    OPWORD    $A07D
  123.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  124.         IMPORT_CFM_FUNCTION GetDefaultStartup
  125.     ENDIF
  126.  
  127. ;
  128. ; pascal void SetDefaultStartup(DefStartPtr paramBlock)
  129. ;
  130.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  131.         ; parameters:
  132.         ;    paramBlock      => A0
  133.         _SetDefaultStartup:    OPWORD    $A07E
  134.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  135.         IMPORT_CFM_FUNCTION SetDefaultStartup
  136.     ENDIF
  137.  
  138. ;
  139. ; pascal void GetVideoDefault(DefVideoPtr paramBlock)
  140. ;
  141.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  142.         ; parameters:
  143.         ;    paramBlock      => A0
  144.         _GetVideoDefault:    OPWORD    $A080
  145.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  146.         IMPORT_CFM_FUNCTION GetVideoDefault
  147.     ENDIF
  148.  
  149. ;
  150. ; pascal void SetVideoDefault(DefVideoPtr paramBlock)
  151. ;
  152.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  153.         ; parameters:
  154.         ;    paramBlock      => A0
  155.         _SetVideoDefault:    OPWORD    $A081
  156.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  157.         IMPORT_CFM_FUNCTION SetVideoDefault
  158.     ENDIF
  159.  
  160. ;
  161. ; pascal void GetOSDefault(DefOSPtr paramBlock)
  162. ;
  163.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  164.         ; parameters:
  165.         ;    paramBlock      => A0
  166.         _GetOSDefault:    OPWORD    $A084
  167.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  168.         IMPORT_CFM_FUNCTION GetOSDefault
  169.     ENDIF
  170.  
  171. ;
  172. ; pascal void SetOSDefault(DefOSPtr paramBlock)
  173. ;
  174.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  175.         ; parameters:
  176.         ;    paramBlock      => A0
  177.         _SetOSDefault:    OPWORD    $A083
  178.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  179.         IMPORT_CFM_FUNCTION SetOSDefault
  180.     ENDIF
  181.  
  182. ;
  183. ; pascal void SetTimeout(short count)
  184. ;
  185.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  186.         Macro
  187.         _SetTimeout
  188.             move.w              #$0001,A0
  189.             dc.w                $A07F
  190.         EndM
  191.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  192.         IMPORT_CFM_FUNCTION SetTimeout
  193.     ENDIF
  194.  
  195. ;
  196. ; pascal void GetTimeout(short *count)
  197. ;
  198.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  199.         Macro
  200.         _GetTimeout
  201.             sub.l               A0,A0
  202.             dc.w                $A07F
  203.         EndM
  204.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  205.         IMPORT_CFM_FUNCTION GetTimeout
  206.     ENDIF
  207.  
  208. ; 
  209. ;    InstallExtensionNotificationProc
  210. ;
  211. ;    Installs an ExtensionNotificationUPP.
  212. ;
  213. ;    Parameters:
  214. ;        extNotificationProc    The ExtensionNotificationUPP to install.
  215. ;
  216. ;    Results:
  217. ;        noErr        0        The ExtensionNotificationUPP was installed.
  218. ;        paramErr    -50        This ExtensionNotificationUPP has already been installed.
  219. ;        memFullErr    -108    Not enough memory to install the ExtensionNotificationUPP.
  220. ;
  221.  
  222. ;
  223. ; pascal OSErr InstallExtensionNotificationProc(ExtensionNotificationUPP extNotificationProc)
  224. ;
  225.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  226.         Macro
  227.         _InstallExtensionNotificationProc
  228.             moveq               #0,D0
  229.             dc.w                $AA7D
  230.         EndM
  231.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  232.         IMPORT_CFM_FUNCTION InstallExtensionNotificationProc
  233.     ENDIF
  234.  
  235.  
  236. ; 
  237. ;    RemoveExtensionNotificationProc
  238. ;
  239. ;    Removes an ExtensionNotificationUPP.
  240. ;    
  241. ;    Note:    ExtensionNotificationUPPs can't call RemoveExtensionNotificationProc.
  242. ;
  243. ;    Parameters:
  244. ;        extNotificationProc    The ExtensionNotificationUPP to remove.
  245. ;
  246. ;    Results:
  247. ;        noErr        0        The ExtensionNotificationUPP was removed.
  248. ;        paramErr    -50        The ExtensionNotificationUPP was not found, or
  249. ;                            RemoveExtensionNotificationProc was called from within
  250. ;                            a ExtensionNotificationUPP (ExtensionNotificationUPPs can't
  251. ;                            call RemoveExtensionNotificationProc).
  252. ;
  253.  
  254. ;
  255. ; pascal OSErr RemoveExtensionNotificationProc(ExtensionNotificationUPP extNotificationProc)
  256. ;
  257.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  258.         Macro
  259.         _RemoveExtensionNotificationProc
  260.             moveq               #1,D0
  261.             dc.w                $AA7D
  262.         EndM
  263.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  264.         IMPORT_CFM_FUNCTION RemoveExtensionNotificationProc
  265.     ENDIF
  266.  
  267.  
  268. ; 
  269. ;    InstallExtensionTableHandlerProc
  270. ;
  271. ;    Installs an ExtensionTableHandlerUPP. Control is taken away from the system's default
  272. ;    handler and the ExtensionTableHandlerUPP is responsible for all changes to the
  273. ;    ExtensionTable (except for incrementing extElementIndex between extensions). This is
  274. ;    always the first handler called with extNotificationBeforeFirst and
  275. ;    extNotificationBeforeCurrent messages and the last handler called with
  276. ;    extNotificationAfterLast and extNotificationAfterCurrent messages. extElementIndex
  277. ;    is always incremented immediately after the ExtensionTableHandlerUPP is called with
  278. ;    the extNotificationAfterCurrent message.
  279. ;    
  280. ;    There can only be one ExtensionTableHandler installed.
  281. ;    
  282. ;    Warning:    The only safe time to change what ExtensionElement is at
  283. ;                ExtensionTable.extElements[extElementIndex] is when your
  284. ;                ExtensionTableHandlerUPP is called with the extNotificationAfterCurrent
  285. ;                message. You may change the ExtensionTable or the extElementIndex at other
  286. ;                times, but you must ensure that the ExtensionElement at
  287. ;                ExtensionTable.extElements[extElementIndex] stays the same.
  288. ;                
  289. ;    Note:        If the ExtensionTable or the contents of the folders included in the
  290. ;                ExtensionTable are changed after installing an ExtensionTableHandler,
  291. ;                RemoveExtensionTableHandlerProc cannot be called.
  292. ;
  293. ;    Parameters:
  294. ;        extMgrProc            The ExtensionTableHandlerUPP to install.
  295. ;        extTable            A pointer to an ExtensionTableHandle where
  296. ;                            InstallExtensionTableHandlerProc will return the current
  297. ;                            ExtensionTableHandle. You don't own the handle itself and
  298. ;                            must not dispose of it, but you can change the extElementIndex.
  299. ;                            the extElementCount, and the ExtensionElements in the table.
  300. ;
  301. ;    Results:
  302. ;        noErr        0        The ExtensionTableHandlerUPP was installed.
  303. ;        paramErr    -50        Another ExtensionTableHandlerUPP has already been installed.
  304. ;        memFullErr    -108    Not enough memory to install the ExtensionTableHandlerUPP.
  305. ;
  306.  
  307. ;
  308. ; pascal OSErr InstallExtensionTableHandlerProc(ExtensionTableHandlerUPP extMgrProc, ExtensionTableHandle *extTable)
  309. ;
  310.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  311.         Macro
  312.         _InstallExtensionTableHandlerProc
  313.             moveq               #2,D0
  314.             dc.w                $AA7D
  315.         EndM
  316.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  317.         IMPORT_CFM_FUNCTION InstallExtensionTableHandlerProc
  318.     ENDIF
  319.  
  320.  
  321. ; 
  322. ;    RemoveExtensionTableHandlerProc
  323. ;
  324. ;    Remove an ExtensionTableUPP. Control is passed back to the default handler.
  325. ;
  326. ;    Parameters:
  327. ;        extMgrProc            The ExtensionTableUPP to remove.
  328. ;
  329. ;    Results:
  330. ;        noErr        0        The ExtensionTableUPP was removed.
  331. ;        paramErr    -50        This ExtensionTableUPP was not installed,
  332. ;                            or the ExtensionTable no longer matches the
  333. ;                            original boot ExtensionTable.
  334. ;
  335.  
  336. ;
  337. ; pascal OSErr RemoveExtensionTableHandlerProc(ExtensionTableHandlerUPP extMgrProc)
  338. ;
  339.     IF TARGET_OS_MAC ** TARGET_CPU_68K ** ¬ TARGET_RT_MAC_CFM THEN
  340.         Macro
  341.         _RemoveExtensionTableHandlerProc
  342.             moveq               #3,D0
  343.             dc.w                $AA7D
  344.         EndM
  345.     ELSEIF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  346.         IMPORT_CFM_FUNCTION RemoveExtensionTableHandlerProc
  347.     ENDIF
  348.  
  349.     ENDIF ; __START__ 
  350.  
  351.